home *** CD-ROM | disk | FTP | other *** search
/ Aminet 50 / Aminet 50 (2002)(GTI - Schatztruhe)[!][Aug 2002].iso / Aminet / hard / drivr / BetaScanUmax.lha / sane-umax.ftxt next >
Text File  |  2001-08-13  |  7KB  |  266 lines
  1.  
  2.  
  3.  
  4. sane-umax(5)                                         sane-umax(5)
  5.  
  6.  
  7. NAME
  8.        sane-umax - SANE backend for UMAX scanners
  9.  
  10.  
  11. ABOUT THIS FILE
  12.        This  file  only is a short descripton of the umax-backend
  13.        for sane! For detailled information take a look  at  sane-
  14.        umax-doc.html (it is included in the sane source directory
  15.        and in the xsane online help)!
  16.  
  17.  
  18. DESCRIPTION
  19.        The sane-umax library implements a SANE backend that  pro­
  20.        vides acces to several UMAX-SCSI-scanners and some Linotye
  21.        Hell SCSI-scanners, parallel-  and  USB-scanners  are  not
  22.        (and propably will never be) supported!
  23.  
  24.        I  suggest  you  hold  one hand on the power-button of the
  25.        scanner while you try the first scans!
  27.  
  28. CONFIGURATION
  29.        The  configuration  file  for  this  backend  resides   in
  30.             /usr/local/etc/sane.d/umax.conf.
  31.  
  32.        Its  contents is a list of device names that correspond to
  33.        UMAX and UMAX compatible scanners. Empty lines  and  lines
  34.        starting  with  a hash mark (#) are ignored. A sample con­
  35.        figuration file is shown below:
  36.  
  37.         #scsi Vendor Model Type Bus Channel ID LUN
  38.         scsi UMAX * Scanner * * * * *
  39.         /dev/scanner
  40.         # this is a comment
  41.         #
  42.         option scsi-maxqueue 4
  43.         option scsi-buffer-size-min 65536
  44.         option scsi-buffer-size-max 131072
  45.         option scan-lines 40
  46.         option preview-lines 10
  47.         option scsi-maxqueue 2
  48.         option execute-request-sense 0
  49.         option force-preview-bit-rgb 0
  50.         option slow-speed -1
  51.         option care-about-smearing -1
  52.         option calibration-full-ccd -1
  53.         option calibration-width-offset -1
  54.         option calibration-bytes-pixel -1
  55.         option invert-shading-data -1
  56.         option lamp-control-available 0
  57.         /dev/sge
  58.  
  59.         - execute-request-sense:
  60.           values: 0=disabled, 1=enabled, default=0
  61.  
  62.  
  63.  
  64.                           16 august 2000                        1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. sane-umax(5)                                         sane-umax(5)
  71.  
  72.  
  73.           If set to 1 umax_do_request_sense is called in
  74.           umax_do_calibration. This can hang the system
  75.           (but has been enabled until this version)
  76.  
  77.         - scsi-buffer-size-min, scsi-buffer-size-max:
  78.           values: 4096-1048576, default min=65536, max=131072
  79.  
  80.         - scan-lines, preview-lines:
  81.           values: 1-65535,
  82.           default: scan-lines=40, preview-lines=10
  83.           define the maximum number of lines that are scanned
  84.           into one buffer
  85.  
  86.         - force-preview-bit-rgb:
  87.           values: 0=disabled, 1=enabled, default=0
  88.           set preview bit in rgb real scan
  89.  
  90.         - slow-speed, care-about-smearing:
  91.           values: -1=auto, 0=disabled, 1=enabled, default=-1
  92.           dangerous options, needed for some scanners
  93.           do not changed these options until you really know
  94.           what you do, you may destroy your scanner when you
  95.           define wrong values for this options
  96.  
  97.         - calibration-full-ccd:
  98.           values: -1=auto, 0=disabled, 1=enabled, default=-1
  99.           do calibration for each pixel of ccd instead of
  100.           selected image
  101.  
  102.         - calibration-width-offset:
  103.           values: -1=disabled, >=0 set value
  104.           add an offset width to the calculated with for
  105.           image/ccd
  106.  
  107.         - calibration-bytes-pixel:
  108.           values: -1=disabled, 0=not set, 1=1 byte/pixel,
  109.           2=x bytes/pixel
  110.           use # bytes per pixel for calibration
  111.  
  112.         - invert-shading-data:
  113.           values: -1=auto, 0=disabled, 1=enabled, default=-1
  114.           invert shading data before sending it back to the
  115.           scanner
  116.  
  117.         - lamp-control-available:
  118.           values: 0=automatically set by driver - if known,
  119.           1=available, default=0
  120.  
  121.        The special device name must be a generic SCSI device or a
  122.        symlink  to  such  a  device.  To find out to which device
  123.        your scanner is assigned and how you have to set the  per­
  124.        missions of that device, have a look at sane-scsi.
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                           16 august 2000                        2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. sane-umax(5)                                         sane-umax(5)
  137.  
  138.  
  139. SCSI ADAPTER TIPS
  140.        The  ISA-SCSI-adapters  that  are  shipped with some Umax-
  141.        scanners are not supported very well by Linux  (I  suggest
  142.        not  to use it), the PCI-SCSI-adapters that come with some
  143.        Umax-scanners are not supported at all (as far as I know).
  144.        On  other platforms these SCSI-adapters are not supported.
  145.        So you typically need  to  purchase  another  SCSI-adapter
  146.        that is supported by your platform. See the relevant hard­
  147.        ware FAQs and HOWTOs for your platform for  more  informa­
  148.        tion.
  149.  
  150.        The  UMAX-scanners do block the scsi-bus for a few seconds
  151.        while scanning. It is not necessary to connect the scanner
  152.        to  its  own  SCSI-adapter. But if you need short response
  153.        time for your SCSI-harddisk (e.g. if your  computer  is  a
  154.        file-server)  or  other scsi devices, I suggest you use an
  155.        own SCSI-adapter for your UMAX-scanner.
  156.  
  157.        If you have any problems with  your  Umax  scanner,  check
  158.        your scsi chain (cable length, termination, ...).
  159.  
  160.        See also: sane-scsi(5)
  161.  
  162.  
  163. FILES
  164.        The backend configuration file:
  165.         /usr/local/etc/sane.d/umax.conf
  166.  
  167.        The static library implementing this backend:
  168.         /usr/local/lib/sane/libsane-umax.a
  169.  
  170.        The shared library implementing this backend :
  171.         /usr/local/lib/sane/libsane-umax.so
  172.         (present on systems that support dynamic loading)
  173.  
  174.  
  175. ENVIRONMENT
  176.        SANE_DEBUG_UMAX
  177.         If  the  library was compiled with debug support enabled,
  178.        this environment variable controls  the  debug  level  for
  179.        this backend. E.g., a value of 128 requests all debug out­
  180.        put  to  be  printed.  Smaller  levels  reduce  verbosity:
  181.        SANE_DEBUG_UMAX values
  182.  
  183.  
  184.         Number  Remark
  185.         0       print important errors (printed each time)
  186.         1       print errors
  187.         2       print sense
  188.         3       print warnings
  189.         4       print scanner-inquiry
  190.         5       print informations
  191.         6       print less important informations
  192.         7       print called procedures
  193.  
  194.  
  195.  
  196.                           16 august 2000                        3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. sane-umax(5)                                         sane-umax(5)
  203.  
  204.  
  205.         8       print reader_process messages
  206.         10      print called sane-init-routines
  207.         11      print called sane-procedures
  208.         12      print sane infos
  209.         13      print sane option-control messages
  210.        Example:
  211.        export SANE_DEBUG_UMAX=8
  212.  
  213.  
  214. BUGS
  215.        X-resolutions greater than 600 dpi sometimes make problems
  216.  
  217.  
  218. AUTHOR
  219.        Oliver Rauch
  220.  
  221.  
  222. EMAIL-CONTACT
  223.        Oliver.Rauch@Wolfsburg.DE
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.                           16 august 2000                        4
  263.  
  264.  
  265.  
  266.